Copyright ã1993 by Novell, Inc. and NeXT Computer, Inc.  All Rights Reserved.

Server Platform Services
The Server Platform calls are closely related to the Connection Services calls. Server Platform services allow a client to enable and disable file server login, and return information and statistics about file server configurations and activity. The server information returns in a structure form as defined in Appendix A of the NetWare C Interface for Univel Reference Manual. Most of these calls require supervisory access privileges.

Function Calls

The Server Platform calls provide two major types of services: 1) disable and enable servers, and 2) get and set server information. Listed below are the calls and their services.

Disable and Enable Servers	Get and Set Server Information

NWDisableServerPlatformLogin	NWGetDiskUtilization

NWDownServerPlatform	NWGetServerPlatformDateAndTime

NWEnableServerPlatformLogin	NWGetServerPlatformInformation
	NWGetServerPlatformName
	NWGetServerPlatformDescriptionStrings
	NWGetServerPlatformLoginStatus
	NWIsNetWare386
	NWSetServerPlatformDateAndTime

Date and Time

The information on date and time on the server is not the same as those defined in the file system services. Server date and time information are stored in a structure while the file system's date and time information are stored in 4 bytes. Table 28 lists the fields in the NWServerPlatformDateAndTime_t Structure. A description of each field follows the table.

TABLE 28.	NWServerPlatformDateAndTime_t Structure

Field	Type

year	uint8
month	uint8
day	uint8
hour	uint8
minute	uint8
second	uint8
dayOfWeek	uint8

year. The year field passes in a value from 0 through 99. For example, 91 becomes 1991, and 10 becomes 2010.

month. The month field passes in a value from 1 through 12.

day. The day field passes in a value from 1 through 31.

hour. The hour field passes in a value from 0 through 23. Noon is 12.

minute. The minute field passes in a value from 0 through 59.

second. The second field passes in a value from 0 through 59.

dayOfWeek. The dayOfWeek field passes in a value from 0 through 6. Sunday is 0.

Boolean Functions

NWIsNetWare386 is the only server call to return 1 if success or 0 if fails. This call returns a boolean rather than an integer type.

Disabling Logins

Disabling the login does not allow users to log in. If the application disables the login and then loses its connection (or logout), the server will have to be 
rebooted. For practical reasons, the application should disable the login, perform intended tasks or operations on the server, and then enable the login.

To see whether the login is disabled, call NWGetServerPlatformLoginStatus.

Getting and Setting Server Information

The types of server information available to an application are listed below. The list also includes how each type of information is set.

Types of Server Information	How the Information Is Set

Server's Date and Time	Call NWSetServerPlatformDateAndTime

Server Platform Information	When the server is configured

Server Name	Set at installation

Server Description Strings	Internal to NetWare

Server Login Status	Call NWDisableServerPlatformLogin, or 
	NWEnableServerPlatformLogin